ICAOffers.AddNew

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The AddNew property creates a new offer and adds it to the collection.

Syntax

objCAOffers.AddNew(
    Policy As ICAPolicy, 
    strName As String, 
    dateStart As Date, 
    dateEnd As Date) As CAOffer

Parameters

  Policy

Specifies the ICAPolicy object that is creating this offer.

  strName

String containing the short description of the offer.

  dateStart

Date and time when the offer becomes valid, as a DATE type.

  dateEnd

Date and time when the offer expires, as a DATE type.

Error Codes

If the property fails, an error is raised and Err.Number is set to a value other than zero.

Return Values

Returns a new CAOffer object.

Remarks

Retrieving this property triggers an ItemAdded event.

After creating a new offer, the client should do the following:

• Add descriptions in the other formats. See CAOffer.Description.
• Add one or more tolls to the offer. If an offer has no tolls, there is no way for the user to purchase it. See CAOffer.Tolls.

This property is read-only.

See Also

• ICAOffers Object